Transform-Related Functions Applicable to Bitmap Shapes (IM: XG)

Inside Macintosh: QuickDraw GX Graphics /: Chapter 5 - Bitmap Shapes / Applying Functions Described Elsewhere to Bitmap Shapes

Transform-Related Functions Applicable to Bitmap Shapes
Although bitmap shapes do not make full use of their style and ink objects, they do make full use of their transform objects. You can apply all of the shape-related functions that are described in the chapter "Transform Objects" in Inside Macintosh: QuickDraw GX Objects to bitmap shapes.
Table 5-5 gives important bitmap-related information for a subset of the functions from that chapter. Functions described in that chapter that do not appear in this list exhibit the same behavior when applied to bitmap shapes as they do when applied to other types of shapes.
Transform-related functions that exhibit special behavior when applied to bitmaps
Function name Action taken
GXGetShapeHitTest Returns the hit-test parameters associated with the bitmap shape's transform. QuickDraw GX hit-tests bitmaps using only the boundsPart shape part.
GXMapShape Multiplies the mapping associated with the transform object of the bitmap shape (if the gxMapTransformShape shape attribute of the bitmap shape is set) by a mapping matrix, or applies the mapping directly to the geometry of the bitmap (if the gxMapTransformShape attribute is not set). Depending on the mapping, this function may also change the clip shape of the bitmap.
GXMoveShape Moves the bitmap by a specified distance. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the gxMapTransformShape shape attribute of the bitmap shape.
GXMoveShapeTo Moves the bitmap to a specified position. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the gxMapTransformShape shape attribute of the bitmap shape.
GXRotateShape Rotates the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the gxMapTransformShape shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXScaleShape Scales the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the gxMapTransformShape shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXSkewShape Skews the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the gxMapTransformShape shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXSetShapeClip Assigns a clip shape to the transform object associated with the bitmap shape.
GXSetShapeHitTest Assigns hit-test parameters to the transform object associated with the bitmap shape. QuickDraw GX only hit-tests bitmaps using the boundsPart shape part.
GXSetShapeMapping Changes the mapping associated with the transform object of the bitmap shape (if the gxMapTransformShape shape attribute of the bitmap shape is set) or applies the mapping directly to the geometry of the bitmap (if the gxMapTransformShape attribute is not set). Depending on the mapping, this function may also change the clip shape of the bitmap.

Transform-related functions that exhibit special behavior when applied to bitmaps
Function name	Action taken
GXGetShapeHitTest	Returns the hit-test parameters associated with the bitmap shape's transform. QuickDraw GX hit-tests bitmaps using only the `boundsPart` shape part.
GXMapShape	Multiplies the mapping associated with the transform object of the bitmap shape (if the `gxMapTransformShape` shape attribute of the bitmap shape is set) by a mapping matrix, or applies the mapping directly to the geometry of the bitmap (if the `gxMapTransformShape` attribute is not set). Depending on the mapping, this function may also change the clip shape of the bitmap.
GXMoveShape	Moves the bitmap by a specified distance. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the `gxMapTransformShape` shape attribute of the bitmap shape.
GXMoveShapeTo	Moves the bitmap to a specified position. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the `gxMapTransformShape` shape attribute of the bitmap shape.
GXRotateShape	Rotates the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the `gxMapTransformShape` shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXScaleShape	Scales the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the `gxMapTransformShape` shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXSkewShape	Skews the bitmap. This function can affect the mapping of the bitmap's transform or the geometry of the bitmap itself, depending on the value of the `gxMapTransformShape` shape attribute of the bitmap shape. This function can also affect the clip shape of the bitmap.
GXSetShapeClip	Assigns a clip shape to the transform object associated with the bitmap shape.
GXSetShapeHitTest	Assigns hit-test parameters to the transform object associated with the bitmap shape. QuickDraw GX only hit-tests bitmaps using the `boundsPart` shape part.
GXSetShapeMapping	Changes the mapping associated with the transform object of the bitmap shape (if the `gxMapTransformShape` shape attribute of the bitmap shape is set) or applies the mapping directly to the geometry of the bitmap (if the `gxMapTransformShape` attribute is not set). Depending on the mapping, this function may also change the clip shape of the bitmap.